批量修改任务基本配置

批量修改任务基本配置

  • ​请求地址​: /v2/webservice/table/analysis-export-task/batch-update-common-config
  • ​请求方法​: POST
  • ​接口描述​: 批量修改任务的通用配置(run_task_time、make_data_time、api_write_interface)

请求参数

请求体参数

参数名类型必填描述
app_idnumber是应用 ID
task_namesstring[]是需要修改的任务名列表(至少1个)
run_task_timestring否每天启动时间,格式 HH:mm:ss,不得小于 03:00:00
make_data_timestring否要构造的数据时间,格式 HH:mm:ss,为空代表构造到冷备时间点数据
api_write_interfacenumber否写入数据方式,1: setData, 2: setKey&setValue

请求示例

示例1:批量修改启动时间

{
  "app_id": 100915,
  "task_names": ["task_001", "task_002", "task_003"],
  "run_task_time": "10:00:00"
}

示例2:批量修改多个配置

{
  "app_id": 100915,
  "task_names": ["task_001", "task_002"],
  "run_task_time": "18:00:00",
  "make_data_time": "09:00:00",
  "api_write_interface": 1
}

示例3:仅修改数据写入方式

{
  "app_id": 100915,
  "task_names": ["task_001"],
  "api_write_interface": 2
}

返回参数

参数名类型描述
codenumber错误码,0 表示成功
messagestring错误信息,成功时为 “success”
dataobject返回数据
data.task_listarray任务修改结果列表

task_list 数组元素参数

参数名类型描述
app_idnumber应用 ID
task_namestring任务名称
task_idnumber事务 ID
resultnumber操作结果状态码

返回示例

成功返回

{
  "code": 0,
  "message": "success",
  "data": {
    "task_list": [
      {
        "app_id": 100915,
        "task_name": "task_001",
        "task_id": 123456,
        "result": 0
      },
      {
        "app_id": 100915,
        "task_name": "task_002",
        "task_id": 123457,
        "result": 0
      }
    ]
  }
}

失败返回

{
  "code": 102,
  "message": "以下任务不存在",
  "data": {
    "not_exist_task_names": ["task_999"]
  }
}